home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / lollipop / trace.tex < prev   
Text File  |  1993-01-28  |  1KB  |  46 lines
  1. % Trace.tex copyright 1992 Victor Eijkhout
  2. %
  3. \Chapter[chap:tracing] Tracing
  4.  
  5. \Section Do you really want to see this?
  6.  
  7. You can get glimpses of Lollipop's internal workings by enabling some
  8. of the internal traces. The extreme positions
  9. \Ver>    \Trace:yes<Rev
  10. and
  11. \Ver>    \Trace:no<Rev
  12. cause all trace information and no trace at all respectively to be
  13. generated. You may find this trace interesting, or it may dumbfound you.
  14. Of course, if your name is Victor you find it pretty useful.
  15.  
  16. The following traces are available:
  17. \Ver>    \NewTrace:def  % definition of user constructs
  18.     \NewTrace:ref  % cross references
  19.     \NewTrace:ext  % external files
  20.     \NewTrace:doc  % document structure
  21.     \NewTrace:font % font loading
  22.     \NewTrace:out  % output routine
  23.     \NewTrace:indent % indentation control
  24.     \NewTrace:gen  % general tools<Rev
  25.  
  26. \ImpNote
  27. Trace messages are generated by calls to
  28. \Ver>    \Tmessage[type]{text}<Rev
  29. Setting
  30. \Ver>    \Trace:no<Rev
  31. defines \cs{Tmessage} to discard its arguments. This is the most
  32. efficient way of generating no trace information.
  33.  
  34. Tracing is controlled by a global parameter \cs{trace@all}. 
  35. A value of~$-1$
  36. disables all tracing; $+1$~corresponds to all tracing on; $0$~gives
  37. selective tracing. In the third case a call
  38. \Ver>    \Trace:xyz<Rev
  39. set \ver>\trace:xyz> positive so that only 
  40. \ver>\Tmessage[xyz]{...}> calls will
  41. produce output. Enabling a selective trace sets \cs{trace@all} to zero, in
  42. case it was~$-1$.
  43. \ImpNoteStop
  44.  
  45.  
  46.